OpenHelp Überblick

OpenHelp ist ein Hilfsprogramm, mit dem Sie einen exakten Bereich für die Inhalte angeben können, auf die Sie normalerweise mit der Hilfe zugreifen. OpenHelp.exe ist Teil des C++Builder.

Mit OpenHelp können Sie festlegen, welche Hilfedateien durchsucht werden, wenn Sie die Hilfe benutzen. Sie können mehrere Suchbereiche einrichten, so daß Sie den jeweils angemessenen Suchbereich für Ihre momentane Arbeit aussuchen können. Der Suchbereich legt fest, welche Hilfedateien im Inhalt der Hilfe eingeschlossen werden und ebenso auf welche Hilfedateien der Index zugreifen kann.

Mehrere Vorgabesuchbereiche sind in OpenHelp eingerichtet. Sie können alle Hilfedateien einbeziehen, nur diejenigen Hilfedateien auswählen, die sich auf Funktionen der IDE beziehen oder Microsoft Windows SDK-Hilfedateien auswählen. Sie können auch Hilfedateien hinzufügen, falls Sie andere Tools mit C++Builder benutzen.

Wählen Sie das für Sie interessante Thema aus:

OpenHelp starten

Suchbereiche auswählen

Einen Suchbereich erstellen

Suchbereiche verwalten

Hilfedateien hinzufügen

Hilfedateien entfernen

Einträge im Inhaltsverzeichnis von Hilfedateien hinzufügen/entfernen

Ein Produkt auswählen, mit dem Sie arbeiten möchten


OpenHelp starten

Folgendermaßen starten Sie OpenHelp:

Klicken Sie das OpenHelp-Symbol an.

oder

Klicken Sie OpenHelp.exe standardmäßig im Verzeichnis C:\Programme\Gemeinsame Dateien\Borland\OpenHelp an.

Wenn Sie OpenHelp beenden möchten, klicken Sie OK an, um alle während der Sitzung vorgenommenen Änderungen abzuspeichern. Wenn Sie Abbrechen anklicken, verlieren Sie alle vorgenommenen Änderungen (wie z.B. das Hinzufügen von Suchbereichen oder die Änderung des momentanen Suchbereichs).


Einen Suchbereich auswählen

Folgendermaßen wählen Sie einen Suchbereich in OpenHelp aus:

1.	Klicken Sie die Registerkarte Suchbereiche in OpenHelp an.

2.	Klicken Sie in dem Listenfeld Suchbereiche den Suchbereich an, den Sie benutzen möchten.

3.	Wählen Sie Auswählen.


Einen Suchbereich erstellen

Folgendermaßen erstellen Sie einen Suchbereich in OpenHelp:

1.	Klicken Sie die Registerkarte Suchbereiche in OpenHelp an.

2.	Wählen Sie Erstellen.

3.	Geben Sie einen Namen für den neuen Suchbereich ein und klicken Sie OK an.

4.	Wählen Sie die Hilfedateien in der Liste der verfügbaren Hilfedateien aus, die Sie miteinbeziehen möchten. Mit den Schaltern > und >> können Sie Dateien zu den ausgewählten Hilfedateien verschieben.

5.	Wenn Sie OpenHelp beenden möchten, klicken Sie OK an, um Ihre Änderungen einschließlich des neuen Suchbereiches abzuspeichern.

Beachten Sie, daß Sie auch einen Suchbereich erstellen können, indem Sie einen vorhandenen kopieren und darin Hilfedateien löschen oder hinzufügen.

Folgendermaßen erstellen Sie einen Suchbereich durch das Kopieren eines vorhandenen:

1.	Klicken Sie die Registerkarte Suchbereiche in OpenHelp an.

2.	Klicken Sie den Suchbereich im Listenfeld Suchbereiche an, den Sie kopieren möchten.

3.	Wählen Sie Kopieren.

3.	Geben Sie einen Namen für den neuen Suchbereich ein und klicken Sie OK an.

4.	Ändern Sie die Liste in Ausgewählte Hilfedateien. Mit den Schaltern > und < können Sie Dateien in dem Bereich hinzufügen oder entfernen.

5.	Wenn Sie OpenHelp beenden möchten, klicken Sie OK an, um Ihre Änderungen einschließlich des neuen Suchbereiches abzuspeichern.


Hilfedateien hinzufügen

Folgendermaßen fügen Sie Hilfedateien in OpenHelp hinzu:

1.	Klicken Sie die Registerkarte Suchbereiche in OpenHelp an.

2.	Wählen Sie Hinzufügen unter der Liste der verfügbaren Hilfedateien.

3.	Blättern Sie im Dialogfeld Öffnen bis zu der HLP-Datei, die Sie in Verfügbare Hilfedateien hinzufügen möchten und wählen Sie Öffnen.


Hilfedateien entfernen

Folgendermaßen löschen Sie Hilfedateien aus OpenHelp:

1.	Klicken Sie die Registerkarte Suchbereiche in OpenHelp an.

2.	Wählen Sie die Hilfedatei aus, die in OpenHelp gelöscht werden soll.

3.	Wählen Sie Entfernen unter der Liste der verfügbaren Hilfedateien.

Beachten Sie, daß durch Löschen einer Hilfedatei in OpenHelp, diese nicht von der Festplatte gelöscht wird.


Die Seite Suchbereiche

Auf der Seite Suchbereiche können Sie sehen, welcher Suchbereich Aktueller Suchbereich ist. Wählen Sie einen neuen aktuellen Suchbereich oder erstellen, kopieren oder löschen Sie Suchbereiche. Sie können Hilfedateien in OpenHelp auch hinzufügen und entfernen.


Aktueller Suchbereich

Der aktuelle Suchbereich ist derjenige, den das Windows Hilfesystem bei der Suche und Anzeige von Indizes von Hilfedateien benutzt. Jedes Programm verfügt über seinen eigenen Suchbereich. Der aktuelle Suchbereich für das von Ihnen eingesetzte Programm wird auf der Seite Suchbereich angezeigt.


Die Liste Suchbereiche

Die Liste Suchbereiche enthält alle Suchbereiche, die für das aktuelle Produkt definiert wurden. Jeder Suchbereich enthält eine Liste von Hilfedateien. Die Indexeinträge der Hilfedateien, die zum ausgewählten Suchbereich gehören, werden in den Indizes der anderen Hilfedateien berücksichtigt, die dem aktuellen Programm zugewiesen sind.

Der momentan benutzte Suchbereich wird unter Aktueller Suchbereich angezeigt, der sich oberhalb der Liste Suchbereiche befindet. Sie können den aktuellen Suchbereich ändern, indem Sie den gewünschten Suchbereich in der Liste Suchbereiche markieren und Auswählen wählen.

Sie erstellen einen neuen Suchbereich, indem Sie Erstellen wählen.

Um einen Suchbereich zu kopieren, markieren Sie den gewünschten Suchbereich in der Liste Suchbereiche und wählen dann Kopieren.

Um einen Suchbereich zu löschen, markieren Sie den gewünschten Suchbereich in der Liste Suchbereiche und wählen dann Löschen.


Der Schalter Auswählen

Dieser Schalter macht den momentan in der Suchbereicheliste markierten Suchbereich zum aktuellen Suchbereich. Beachten Sie, daß beim Anklicken von Auswählen der im Aktueller Suchbereich angezeigte Suchbereichsname oberhalb der Suchbereichsliste in den neu ausgewählten Suchbereich geändert wird.

Die Indexeinträge der Hilfedateien, die im aktuellen Suchbereich berücksichtigt werden, werden den Indizes der anderen Hilfedateien hinzugefügt, die zum aktuellen Produkt gehören.


Der Schalter Erstellen

Dieser Schalter erstellt einen neuen, ursprünglich leeren Suchbereich für das aktuelle Produkt. Wenn Sie den Erstellen-Schalter anklicken, wird ein Dialog angezeigt, indem Sie den Namen des neuen Suchbereichs eingeben müssen. Der neue Suchbereichsname darf nicht leer bleiben und nicht demjenigen eines bereits vorhandenen Suchbereichs entsprechen.


Der Schalter Kopieren

Dieser Schalter erstellt eine Kopie des momentan in der Suchbereichsliste markierten Suchbereichs. Wenn Sie den Kopieren-Schalter anklicken, wird der Dialog Suchbereich erstellen angezeigt, in dem Sie den Namen für den neuen Suchbereich eingeben müssen. Der neue Suchbereichsname darf nicht leer bleiben und nicht demjenigen eines bereits vorhandenen Suchbereichs entsprechen. Der neue Bereich wird dieselben Hilfedateien enthalten, wie derjenige von dem er kopiert wurde.


Das Dialogfeld Suchbereich erstellen

Geben Sie einen Namen für den neuen Suchbereich im Feld Name des Suchbereichs ein. Der neue Suchbereichsname darf nicht leer bleiben und nicht demjenigen eines bereits vorhandenen Suchbereichs entsprechen.


Der Schalter Löschen

Dieser Schalter löscht den Suchbereich, der in der Suchbereichsliste markiert ist. Den aktuellen Suchbereich können Sie nicht löschen.


Die Liste Verfügbare Hilfedateien

Verfügbare Hilfedateien listet alle Hilfedateien auf, die dem aktuellen Produkt zugeordnet sind und die nicht im markierten Suchbereich in der Liste Suchbereiche enthalten sind. Dateien in dieser Liste können Suchbereichen hinzugfügt werden.


Der Schalter Hinzufügen

Dieser Schalter zeigt den Dialog Öffnen an, mit dem Sie zusätzliche Hilfedateien zur Liste Verfügbare Hilfedateien hinzufügen können. Wenn Dateien in dieser Liste hinzugefügt werden, werden diese Dateien dem aktuellen Produkt zugeordnet und damit können diese Dateien in Suchbereichen hinzugefügt werden.

Alle in der Liste hinzugefügten Dateien müssen bereits vorhanden sein und die Namenserweiterung HLP aufweisen.

Wenn eine Datei hinzugefügt wird, die sich in dem Verzeichnis befindet, das als das Stammverzeichnis des aktuellen Produkts definiert wurde, muß deren Inhaltsdatei (CNT) so geändert werden, daß die Konfigurationsdatei den aktuellen Suchbereich dieses Programms mitberücksichtigt. Bei einer hinzugefügten Datei, die sich nicht im Stammverzeuchnis des aktuellen Produkts befindet, muß die Inhaltsdatei nicht geändert werden.


Der Schalter Entfernen

Dieser Schalter entfernt die Hilfedateien in der Liste verfügbare Hilfedateien aus der Liste. Das Entfernen der Hilfedateien aus der Liste entfernt diese auch aus allen Suchbereichen für das aktuelle Produkt, in denen sie enthalten waren. Das Entfernen der Hilfedateien aus der Liste löscht die Dateien jedoch nicht von der Festplatte, es entfernt lediglich die Zuordnung zwischen der Hilfedatei und dem Programm.

Bei allen entfernten Dateien, die sich in dem Verzeichnis befinden, das als Stammverzeichnis des aktuellen Programms definiert wurde, müssen deren Inhaltsdateien (.CNT) geändert werden, in dem die Konfigurationsdatei für das Programm entfernt wird. Befanden sich die entfernten Dateien nicht im Stammverzeichnis des aktuellen Produkts, so müssen deren Inhaltsdateien nicht geändert werden.


Der Schalter >

Dieser Schalter fügt die in der Liste Verfügbare Hilfedateien markierten Hilfedateien der Liste Ausgewählte Hilfedateien und zum markierten Suchbereich in der Liste Suchbereiche hinzu.


Der Schalter >>

Dieser Schalter fügt alle Dateien in der Liste Verfügbare Hilfedateien der Liste Ausgewählte Hilfedateien und zum markierten Suchbereich in der Liste Suchbereiche hinzu.


Der Schalter <

Dieser Schalter entfernt die markierten Hilfedateien in der Liste Ausgewählte Hilfedateien und im markierten Suchbereich in der Liste Suchbereiche und stellt sie wieder in die Liste Verfügbare Hilfedateien.


Der Schalter <<

Dieser Schalter entfernt alle Hilfedateien in der Liste Ausgewählte Hilfedateien und aus dem markierten Suchbereich in der Liste Suchbereiche und stellt sie wieder in die Liste Verfügbare Hilfedateien.


Die Liste Ausgewählte Hilfedateien

Ausgewählte Hilfedateien listet alle Hilfedateien auf, die dem aktuellen Produkt zugeordnet sind, das in dem markierten Suchbereich in der Liste Suchbereiche enthalten ist.


Die Seite Inhaltsdatei

Mit der Seite Inhaltsdatei können Sie eine der Hilfedateien auswählen, die dem aktuellen Produkt zugeordnet sind und fügen Sie Einträge im Inhaltsverzeichnis hinzu oder entfernen Sie die in dieser Datei verfügbaren, indem Sie eine oder mehrere der verfügbaren TOC-Dateien auswählen. Die Reihenfolge bei der Auswahl der TOC-Dateien bestimmt die Reihenfolge der Einträge im Inhaltsverzeichnis bei der Anzeige der Hilfedatei.

Sie können auch TOC-Dateien in der Liste der verfügbaren Inhaltsdateien hinzufügen oder entfernen.


Die Liste Hilfedatei

Die Liste Hilfedatei ist eine Drop-Down-Liste aller mit dem aktuellen Produkt verbundener Hilfedateien. Mit dieser Liste wählen Sie die Hilfedatei aus, deren Inhaltsverzeichniseinträge Sie ändern möchten.


Die Liste Verfügbare Inhaltsdateien

Die Liste Verfügbare Inhaltsdateien enthält alle mit dem aktuellen Produkt verbundenen Inhaltsdateien (TOC), die nicht mit derjenigen Hilfedatei verbunden sind, die in der Liste Hilfedatei ausgewählt ist.


Der Schalter Inhaltsdatei hinzufügen

Dieser Schalter zeigt den Dialog Datei öffnen an, mit dem weitere Inhaltsdateien der Liste Verfügbare Inhaltsdateien hinzugefügt werden können. Wenn Dateien dieser Liste hinzugefügt werden, ordnet das diese Dateien dem aktuellen Produkt zu und sie werden den Hilfedateien hinzugefügt.

Alle dieser Liste hinzugefügten Dateien müssen bereits vorhanden sein und eine TOC-Erweiterung aufweisen.


Der Schalter Inhaltsdateien entfernen

Dieser Schalter entfernt die in der Liste Verfügbare Inhaltsdateien ausgewählten Inhaltsdateien aus der Liste. Das Entfernen der Inhaltsdateien aus der Liste entfernt sie auch aus allen Hilfedateien des aktuellen Produkt, in denen sie enthalten sind. Wenn die Inhaltsdateien aus der Liste entfernt werden, löscht sie das nicht auf der Festplatte, sondern es wird lediglich die Verbindung zwischen der Inhaltsdatei und dem Programm entfernt.


Der Schalter Inhaltsdateien hinzufügen (>)

Dieser Schalter fügt die in der Liste Verfügbare Inhaltsdateien markierten Inhaltsdateien der Liste Ausgewählte Inhaltsdateien und zu der ausgewählten Hilfedatei in der Liste Hilfedatei hinzu.


Der Schalter Alle Inhaltsdateien hinzufügen (>>)

Dieser Schalter fügt alle Inhaltsdateien in der Liste Verfügbare Inhaltsdateien in der Liste Ausgewählte Inhaltsdateien und zu der ausgewählten Hilfedatei in der Liste Hilfedateien hinzu.


Der Schalter Inhaltsdateien entfernen (<)

Dieser Schalter entfernt die markierten Inhaltsdateien in der Liste Ausgewählte Inhaltsdateien und in der ausgewählten Hilfedatei in der Liste Hilfedateien und stellt sie wieder in die Liste Verfügbare Inhaltsdateien.


Der Schalter Alle Inhaltsdateien entfernen (<<)

Dieser Schalter entfernt alle Inhaltsdateien in der Liste Ausgewählte Inhaltsdateien und in der ausgewählten Hilfedatei in der Liste Hilfedateien und stellt sie wieder in die Liste Verfügbare Inhaltsdateien.


Die Liste Ausgewählte Inhaltsdateien

Ausgewählte Inhaltsdateien zeigt eine Liste aller Inhaltsdateien, die dem aktuellen Produkt zugeordnet sind und in der ausgewählten Hilfedatei in der Liste Hilfedatei enthalten sind. Die Reihenfolge der Inhaltsdateien in der Liste entspricht derjenigen bei der Anzeige im Inhaltsverzeichnis der Hilfedatei.


Die Seite Produkte

Die Seite Produkte zeigt, welches Programm das aktuelle Produkt ist. Sie können auswählen, mit welchem Produkt Sie arbeiten möchten. Sie können nur mit Suchbereichen und Hilfedateien arbeiten, die dem aktuellen Produkt zugeordnet sind. Sie können auch neue Produkte erstellen und vorhandene Produkte löschen.


Aktuelles Produkt

Aktuelles Produkt zeigt an, welches Programm Sie gerade benutzen. Nur die Suchbereiche und Hilfedateien des aktuellen Produkts können angezeigt und bearbeitet werden. Um das aktuelle Produkt zu wechseln, müssen Sie einen anderen Programmnamen in der Liste Installierte Produkte markieren und den Schalter Auswählen anklicken.


Die Liste Installierte Produkte

Die Liste Installierte Produkte führt alle Programme auf, die in OpenHelp installiert wurden. Die aufgeführten Produkte können zugeordnete Hilfedateien und Suchbereiche aufweisen.


Der Schalter Produkte auswählen

Der Schalter Produkte auswählen stellt das markierte Produkt in die Liste Installierte Produkt des aktuellen Produkts.


Der Schalter Produkt erstellen

Der Produkt erstellen-Schalter erstellt ein neues Programm in der Liste Installierte Produkte. Wenn Sie den Erstellen-Schalter anklicken, wird der Dialog Neues Produkt erstellen angezeigt. Für das Erstellen eines neuen Programms müssen die folgenden Informationen vorliegen:

Der Name des Programms, z.B. "C++Builder".

Der vom Benutzer vergebene Name der Konfigurationsdatei für das Programm. Ein anderes Programm kann nicht denselben Konfigurationsdateinamen benutzen. Der angegebene Name sollte weder einen Pfad noch eine Dateinamenserweitrung enthalten. Die Konfigurationsdatei für den C++Builder könnte beispielsweise "bcb" lauten.

Das Stamm-Hilfeverzeichnis für das Programm. Dabei handelt es sich um das Verzeichnis, in dem sich die Hilfedateien für das Programm befinden. Die meisten Borland-Programme erstellen ein Verzeichnis namens "Help" eine Ebene unterhalb des Hauptverzeichnisses des Programms zur Ablage der Hilfedateien des Programms. Dieses Hilfeverzeichnis könnte als Stamm-Hilfeverzeichnis des Programms dienen. Standardmäßig wird z.B. C++Builder im Verzeichnis ..\CBuilder installiert. Die Hilfedateien für C++Builder werden standardmäßig in das Verzeichnis  ..\CBuilder\HELP installiert. Wenn Sie dann die Standardverzeichnisse benutzen, wäre das Stamm-Hilfeverzeichnis des C++Builder ..\CBuilder\HELP.


Das Dialogfeld Neues Produkt erstellen

Um ein neues Programm erstellen zu können, müssen folgende Informationen in den Feldern eingegeben werden:

Name

Der Name des Programms, wie z.B. "C++Builder".

Konfiguration

Der vom Benutzer angegebene Name der Konfigurationsdatei für das Programm. Ein anderes Programm kann nicht denselben Konfigurationsdateinamen benutzen. Der angegebene Name sollte weder einen Pfad noch eine Dateierweiterung enthalten. Der Konfigurationsdateiname für den C++Builder könnte z.B. "bcb" lauten.

Stammverzeichnis

Das Stamm-Hilfeverzeichnis für das Produkt. In diesem Verzeichnis werden die Hilfedateien für das Programm abgelegt. Die meisten Borland-Programme erstellen ein Verzeichnis namens "Help" eine Ebene unterhalb des Hauptverzeichnisses des Programms zur Ablage der Hilfedateien für das Programm. Dieses Hilfeverzeichnis könnte das Stamm-Hilfeverzeichnis des Programms sein. Standardmäßig wird z.B. der C++Builder in das Verzeichnis ..\CBuilder installiert. Die Hilfedateien für C++Builder werden standardmäßig in das Verzeichnis ..\CBuilder\HELP installiert. Wenn Sie also die Standardverzeichnisse benutzen, würde das Stamm-Hilfeverzeichnis für den C++Builder ..\CBuilder\HELP lauten. Sie können den Namen des Verzeichnisses in das Feld eingeben oder das Ordnersymbol anklicken, um den Verzeichnisbaum anzuzeigen und ein Verzeichnis auszuwählen.


Der Schalter Produkt löschen

Der Schalter Programm löschen entfernt das markierte Programm in der Liste installierter Produkte in OpenHelp, sowie alle damit zusammenhängenden Suchbereiche und Hilfedateien. Auf der Festplatte werden keine Dateien gelöscht, sie werden nur in OpenHelp entfernt.


OK-Schalter
Der Schalter OK

OK speichert alle vorgenommenen Änderungen und beendet OpenHelp.


Abbrechen-Schalter
Der Schalter Abbrechen

Abbrechen verwirft alle vorgenommenen Änderungen und beendet OpenHelp.


Der Schalter Übernehmen

Anwenden speichert alle vorgenommenen Änderungen.


Hilfe-Schalter
Der Schalter Hilfe

Hilfe zeigt Informationen über OpenHelp an.